

    \filetitle{barcon}{Contribution bar graph for tseries objects}{tseries/barcon}

	\paragraph{Syntax}

\begin{verbatim}
[H,Range] = barcon(X,...)
[H,Range] = barcon(Range,X,...)
[H,Range] = barcon(Ax,Range,X,...)
\end{verbatim}

\paragraph{Input arguments}

\begin{itemize}
\item
  \texttt{Ax} {[} handle \textbar{} numeric {]} - Handle to axes in
  which the graph will be plotted; if not specified, the current axes
  will used.
\item
  \texttt{Range} {[} numeric \textbar{} char {]} - Date range; if not
  specified the entire range of the input tseries object will be
  plotted.
\item
  \texttt{X} {[} tseries {]} - Input tseries object whose columns will
  be plotted as a contribution bar graph.
\end{itemize}

\paragraph{Output arguments}

\begin{itemize}
\item
  \texttt{H} {[} handle \textbar{} numeric {]} - Handles to the bars
  plotted.
\item
  \texttt{Range} {[} numeric {]} - Actually plotted date range.
\end{itemize}

\paragraph{Options}

\begin{itemize}
\item
  \texttt{\textquotesingle{}barWidth=\textquotesingle{}} {[} numeric
  \textbar{} \emph{\texttt{0.8}} {]} - Width of bars as a percentage of
  the space each period occupies on the x-axis.
\item
  \texttt{\textquotesingle{}dateFormat=\textquotesingle{}} {[} char
  \textbar{} cellstr \textbar{}
  \emph{\texttt{\textquotesingle{}YYYYFP\textquotesingle{}}} {]} - Date
  format string, or array of format strings (possibly different for each
  date).
\item
  \texttt{\textquotesingle{}colorMap=\textquotesingle{}} {[} numeric
  \textbar{}
  \emph{\texttt{get(gcf(),\textquotesingle{}colorMap\textquotesingle{})}}
  {]} - Color map used to fill the contribution bars.
\item
  \texttt{\textquotesingle{}evenlySpread=\textquotesingle{}} {[}
  \emph{\texttt{true}} \textbar{} \texttt{false} {]} - Colors picked for
  the contribution bars are evenly spread across the color map.
\item
  \texttt{\textquotesingle{}ordering=\textquotesingle{}} {[}
  \texttt{\textquotesingle{}ascend\textquotesingle{}} \textbar{}
  \texttt{\textquotesingle{}descend\textquotesingle{}} \textbar{}
  \emph{\texttt{\textquotesingle{}preserve\textquotesingle{}}}
  \textbar{} numeric {]} - Ordering of contributions with the same sign
  withinin each period;
  \texttt{\textquotesingle{}preserve\textquotesingle{}} means the
  original order will be preserved.
\end{itemize}

See help on \href{tseries/plot}{\texttt{tseries/plot}} and the built-in
function \texttt{bar} for other options available.

\paragraph{Description}

\paragraph{Example}


